home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 4 / QRZ Ham Radio Callsign Database - Volume 4.iso / files / dsp / 320c26 / dskjnx1.exe / MANUAL.DOC < prev    next >
Text File  |  1994-03-20  |  17KB  |  411 lines

  1. Pactor/Amtor/RTTY Multimode HF software
  2.  
  3. 0. License
  4. ----------
  5.  
  6. This software is copyrighted 1993 by Tom Sailer, HB9JNX, Weinbergstrasse 76,
  7. 8408 Winterthur, Switzerland. You may not use this program for purposes other
  8. than amateur radio. You may not modify this program. You may share this
  9. program, provided you do not charge any fee for use, copying or distributing
  10. and you do not remove or modify any file. Commercial use or distribution is
  11. strictly prohibited without the   w r i t t e n   p e r m i s s i o n   of
  12. the author.
  13. The author hereby disclaims all warranties relating to this software, whether
  14. express or implied, including without limitation any implied warranties of
  15. merchantability or fitness for a particular purpose. The author will not be
  16. liable for any special, incidental, consequential, indirect or similar damages
  17. due to loss of data or any other reason. The person using the software bears
  18. all risk as to the quality and performance of the software.
  19.  
  20. Files belonging to the DJ6HP version
  21. TERMD    EXE        ALLMODE  INI        LICENSE  TXT        MANUAL   DOC     
  22.  
  23. Files belonging to the DSP version
  24. CONV170  DSP        CONV200  DSP        CONV425  DSP        CONV850  DSP      
  25. CONVM    DSP        CONVM200 DSP        FFTSAMPL DSP        TERM     EXE    
  26. ALLMODE  INI        LICENSE  TXT        MANUAL   DOC     
  27.  
  28.  
  29. 1. General overview
  30. -------------------
  31.  
  32. The HB9JNX HF RTTY/Amtor/Pactor software allows you to operate in these
  33. modes using cheap hardware. All the protocols are handled by the computer.
  34. Therefore you need at least a 286 computer, 386 should be better.
  35. There are currently two versions of this software: One for use with a
  36. DJ6HP-like analog converter, the other one for use with the Texas Instruments
  37. DSP Starters Kit with the TMS320C26 (Of course, you can use any hardware
  38. with the TMS320C26 and the TLC32040 whit 40MHz clock frequency). The
  39. DSP version is the preferred one. Its memory ARQ (in Pactor) performs much
  40. superior to that in the DJ6HP version, since the demodulator data is
  41. transferred to the computer with a high precision instead of just "0" or "1".
  42. Additionally, it allows you to use different mark/space separations (useful
  43. to copy commercial RTTY stations) and allows you to set the mark and space
  44. frequencies anywhere in the audio passband of your transceiver. Another
  45. plus is the spectrum display. The demodulator software is what is called
  46. "matched filters", which are the ideal noncoherent FSK demodulator.
  47. This document assumes that you are already familiar with RTTY, Amtor and
  48. Pactor (Pactor is not very different from Amtor from the operators point of
  49. view, except that you are encouraged to type in lower case, since lower case
  50. letters are compressed better). It assumes too that you are familiar with
  51. expressions such as mark frequency, space frequency, how to calculate
  52. the transceiver frequency to receive a particular mark frequency, baud
  53. rates, etc. If not, get help from a nearby ham who's experienced with these
  54. things.
  55.  
  56. 1.1. Connection of the hardware
  57. -------------------------------
  58.  
  59. 1.1.1. DSP Version
  60. ------------------
  61. Connect the DSP Starters Kit to the computer as you would for use with the
  62. Texas Instruments debugger. If you've built the hardware yourself, you must
  63. wire the XF line to the RS232 RXD, the BIO line to the RS232 TXD and the
  64. RS line to the RS232 DTR. Since the DSP is a 5V device and RS232 uses +-12V,
  65. you have to USE APPROPRIATE LINE DRIVERS (such as 1488/1489). You should
  66. invert RXD and TXD once, and DTR twice. (If you inverted DTR only once,
  67. change the ComDTRInvert entry in the allmode.ini file, see also Appendix A)
  68. Connect the Transceiver fixed level audio output (if not available, the try
  69. the phones output, but this may be too slow) to the AIC input or auxin, and
  70. the AIC output to the transceiver input. You may adjust the modem output
  71. level in the allmode.ini file, but it is recommended to use an external
  72. resistor divider network. The transmitter is keyed via the RS232 RTS line.
  73. ATTENTION: +-12V. I recommend the use of transformers for the audio input and
  74. output and an optocoupler for RTS, in order to separate the transceiver
  75. and the computer/modem galvanically.
  76.  
  77. 1.1.2. DJ6HP filter converter version
  78. -------------------------------------
  79. In order to operate Pactor, you need first to make the filter bandwidths
  80. larger. Consult the local Packet BBS. Then connect the converter to
  81. a parallel printer port as follows:
  82. - Converter (digital) output to the BUSY line (Pin 11) (low is mark)
  83. - (A)FSK generator to DATA6 (Pin 8) (high is mark)
  84. - PTT to DATA7 (Pin 9). (high is transmit)
  85. - Ground is Pin 18-26.
  86.  
  87. 1.1.3. Configuring the software
  88. -------------------------------
  89. The configuration is stored in the ALLMODE.INI file. This is an ASCII text
  90. file. See Appendix A for the details on the entrys in this file.
  91.  
  92. 2. Operation
  93. ------------
  94.  
  95. 2.1. Transceiver filters
  96. ------------------------
  97.  
  98. Do not use too narrow receiver IF filters, especially with the DSP version.
  99. These filters usually exhibit a very large phase distortion at the edge
  100. of their passband. Do not use filters narrower than 500Hz. Even 500Hz
  101. may be too narrow, so you probably should try it without the filter.
  102. (Remember: the bandwith taken by a 200 Baud Pactor signal is 400Hz).
  103. Adjust the center frequency of your converter to the center frequency
  104. of the receiver filter.
  105.  
  106. 2.2. Organisation of the user interface
  107. ---------------------------------------
  108.  
  109. The user interface is menu driven. The screen is split into 4 areas:
  110. The Rx window is the largest area. It shows you in white what you received
  111. from the QSO partner, and in blue, what you typed and is already transmitted.
  112. The Tx window is only a few lines and shows what you're currently typing.
  113. Note that the word currently typed is not sent until you type a non-letter
  114. character, in order to allow you to correct mistypings in AMTOR and RTTY.
  115. (In Pactor, you may correct as much as you want, since a BACKSPACE signal
  116. can be sent over the air). The Monitor window shows you what is currently
  117. going on on the air. You need to know the protocol basics in order to
  118. understand what this means. The same holds for the link state window.
  119. The menu is invoked via the F2 key. You may then select every item with
  120. the arrow keys and the ENTER key which is light white. The gray white
  121. items are disabled. Submenus are indicated by an arrow pointing to the right.
  122. I won't explain every menu item, since operation should be quite straight
  123. forward. One note though: On Startup, nothing happens at first. If you want
  124. to listen to a QSO in Amtor or Pactor, you will have to press F4, or if
  125. you want to print RTTY, you will have to press F7. The same can be
  126. accomplished via the menu.
  127.  
  128. 2.3. Tuning
  129. -----------
  130.  
  131. Tuning in the DJ6HP version should be done with an external indicator, such
  132. as an X-Y-scope. Tuning in the DSP version can be accomplished in two ways:
  133. The spectrum display can be used to tune and to determine the spacing between
  134. mark and space. (Note: RTTY and Amtor usually have 170Hz, Pactor has 200Hz,
  135. but Amtor and RTTY with the PTC have also 200Hz, in short 170Hz and 200Hz
  136. are mixed randomly in the amateur community). During a QSO or for fast tuning
  137. you may use the tuning indicator at the top right of the screen.
  138.  
  139. 2.4. Pactor quirks
  140. ------------------
  141. In the Pactor section, there a few things are implemented uncommonly.
  142. There is no automatic algorithm for speed change. That is, you have to
  143. switch manually to 200 baud. Speed down is requested if a packet cannot
  144. be correctly received during 4 cycles. Note that you can only request a
  145. speed up if you are the information receiving station (IRS). The reason
  146. for this is that observations on the band have shown that the original
  147. PTC looses a lot of time trying to speed up without success if the condx
  148. are quite bad. Given the information in the link state window, it should
  149. be quite easy (after you've made some experiences) to decide if 200 bauds
  150. could work. If you try to speed up and fail, the software automatically
  151. falls back to 100 baud. I think this limitation is not too severe since
  152. in any case this terminal software cannot be used for unattended operation.
  153. Pactor disconnect may fail, i.e. if you want to disconnect the other end
  154. you and you miss the first acknowledge, your end tries to disconnect until
  155. the retry counter reaches zero. This is due to (yet another) bug in the
  156. original PTC. Hopefully this will be fixed in the PTCplus design. 
  157. (N.B. this does not work correctly with two original PTCs too). You may
  158. stop transmitting QRT packets by manually pressing F4 (for Listen mode)
  159.  
  160.  
  161. Appendix
  162. --------
  163.  
  164. A. ALLMODE.INI File format
  165. --------------------------
  166.  
  167. A.1. General Format
  168. -------------------
  169.  
  170. This file is an ordinary ASCII Text file, without any control sequences. It
  171. is organised in sections. The section names are enclosed in square brackets.
  172. [section]
  173. key=value
  174. ...
  175. If value is a boolean, then it may be either 0,F,1 or T. Integer numbers may
  176. be either decimal or hexadecimal, terminated with a "H".
  177.  
  178.  
  179. A.2. Section [DSP] (not available in the DJ6HP version)
  180. ------------------
  181.  
  182. AICLevel=0
  183.   This parameter specifies the adc input range.
  184.   0 = -1.5 .. 1.5 Volts
  185.   1 = -3 .. 3 Volts
  186.   2 = -6 .. 6 Volts
  187.  
  188. AICAuxIn=T
  189.   This parameter specifies whether the normal input (F) or the auxilary
  190.   input (T) should be used.
  191.  
  192. ConvTXAttenuation=15
  193.   This parameter specifies the attenuation of the audio output level (in
  194.   decibels, not negative and integer).
  195.  
  196. ConvAdjust=9500H
  197.   In the DSP version, the whole timing is controlled by the DSP. This
  198.   parameter may be used to adjust the clock of the DSP board. Increase it
  199.   if the clock is too slow. An indication for this is the "dt" value in the
  200.   status display, if it is mostly negative, WHEN YOU HAVE BEEN CONNECTED, I.E.
  201.   AMTOR SLAVE OR PACTOR SLAVE MODE, then try to increase this value
  202.   (and vice versa)
  203.  
  204. ComRTSInvert=F
  205.   The RTS line is used as the PTT. Specifies whether you're using
  206.   negative or positive logic.
  207.  
  208. ComDTRInvert=F
  209.   The DTR line is used to reset the DSP. Specifies whether you're using
  210.   negative or positive logic. (Use F for the standard TI DSK board)
  211.  
  212. ComInt=4
  213.   Interrupt line for the com port. Only Ints from 3 to 7 are supported.
  214.   4 for COM1 and COM3, 3 for COM2 and COM4
  215.  
  216. ComAddr=3F8H
  217.   Address of the com port. 3F8H for COM1, 3E8H for COM2, 2F8H for COM3,
  218.   and 2E8H for COM4
  219.  
  220. ProgFile##=CONVM200.DSP
  221.   ## are consecutive numbers starting with 00. Specifies which DSP software
  222.   files are available and should appear in the DSP menu. These are different
  223.   converters. The number in the filename usually stands for the frequency
  224.   shift between mark and space of this specific converter.
  225.  
  226. A.3. Section [FFT] (not available in the DJ6HP version)
  227. ------------------
  228.  
  229. DefaultFreq=1275
  230.   Specifies the default frequency for the cursors in the FFT display.
  231.  
  232. DefaultMark=F
  233.   Specifies whether the above frequency is the mark frequency or the
  234.   space frequency. The other frequency is calculated from this frequency
  235.   and the shift set in the FFT screen.
  236.  
  237. MatchedFilter=CONVM.DSP
  238.   This is the matched filter converter software. This software package
  239.   is able to calculate matched filters for the frequencies you've
  240.   specified in the FFT screen. This is the filter software for these
  241.   matched filters. After leaving the FFT screen or by selecting the
  242.   "Download matched filter" menu command, this filter is downloaded
  243.   to the DSP.
  244.  
  245. Sample=FFTSAMPLE.DSP
  246.   This is the DSP software for the FFT screen
  247.  
  248. Mono=F
  249.   If T, forces the use of a monochrome display mode.
  250.  
  251. ColSpace=10
  252. ColMark=14
  253. ColGrid=4
  254. ColTrace=15
  255. ColText=7
  256.   These are different color settings. Range is from 0 to 15, except for
  257.   the monochrome modes, where it is from 0 to 1
  258.  
  259.  
  260. A.4. Section [DJ6HP] (not available in the DSP version)
  261. --------------------
  262.  
  263. ConvAdjust=20
  264.   In the DJ6HP version, the hole timing is controlled by the computer clock.
  265.   This parameter may be used to adjust the computer clock. Decrease it
  266.   if the clock is too slow. An indication for this is the "dt" value in the
  267.   status display, if it is mostly negative, WHEN YOU HAVE BEEN CONNECTED, I.E.
  268.   AMTOR SLAVE OR PACTOR SLAVE MODE, then try to decrease this value
  269.   (and vice versa) (ATTN: It's exactly the other way round as with the
  270.   parameter of the same name in the DSP section!!)
  271.  
  272. LptAddr=3BCH
  273.   This is the address of the LPT port. LPT1 is 378H, LPT2 is 278H, and
  274.   the LPT port on the hercules graphics card is 3BCH. Connect the
  275.   Converter (digital) output to the BUSY line (Pin 11), the (A)FSK
  276.   generator to DATA6 (Pin 8) and PTT to DATA7 (Pin 9). Ground is
  277.   Pin 18-26.
  278.  
  279.  
  280. A.5. Section [RTTY]
  281. -------------------
  282.  
  283. AutoRYRY=T
  284.   If set, when you start RTTY transmitting, repeated RY is transmitted until
  285.   you typed the first word.
  286.  
  287. Bits=5
  288.   The number of data bits. Valid are 5,7 and 8.
  289.  
  290. CCITT=F
  291.   Specifies whether the CCITT or the US MIL code should be used.
  292.  
  293. CRLF=F
  294.   Specifies if a LINEFEED should be sent after CARRIAGE RETURN.
  295.  
  296. Baud=45
  297.   The Baudrate, from 45 to 100.
  298.  
  299. DataReverse=F
  300.   Whether the data bits should be inverted.
  301.  
  302. Reverse=F
  303.   Whether all should be inverted.
  304.  
  305.  
  306. A.6. Section [AMTOR]
  307. --------------------
  308.  
  309. WRU=DE MY0CALL+?
  310.   If not empty, this enables the WRU mechanism. This can be useful for some
  311.   mailboxes which support the WRU mechanism. After connecting, the mailbox
  312.   sends you it's bannertext, followed by the wru? character. Then this
  313.   software gets the key and sends the text you've specified. It should
  314.   end with +? to give the key back to the mailbox. Using this mechanism
  315.   can save you the manual login procedure.
  316.  
  317. RxAfterTx=20
  318.   This value determines how many milliseconds the software should wait before
  319.   starting to send in the SLAVE mode. For DX, set it to TxDelay. If you want
  320.   to do a short range QSO, set it to about 50.
  321.  
  322. TxDelay=20
  323.   This is the number of milliseconds your transceiver needs to key up
  324.  
  325. SelCall=NONE
  326.   This is your selcall. It consists of exactly 4 letters. It is usually
  327.   the concatenation of the first and the last three letters in your callsign.
  328.   if you have only three letters in the callsign, you may take the first one
  329.   twice. Eg. HB9JNX => HJNX, HB9ZZ => HBZZ, ZS5S => ZZSS
  330.  
  331. CrLf=T
  332.   Whether a LINE FEED should be sent after a CARRIAGE RETURN
  333.  
  334. CapsOnly=F
  335.   Whether lowercase should be enabled.
  336.  
  337. TxReverse=F
  338.   Whether the TX should be inverted.
  339.  
  340. Reverse=F
  341.   Whether mark and space should be exchanged.
  342.  
  343. A.7. Section [PACTOR]
  344. ---------------------
  345.  
  346. RxAfterTx=50
  347.   This value determines how many milliseconds the software should wait before
  348.   starting to send in the SLAVE mode. For DX, set it to TxDelay. If you want
  349.   to do a short range QSO, set it to about 50. You can leave it quite high,
  350.   since Pactor has a LongPath mode for DX operation.
  351.  
  352. TxDelay=50
  353.   This is the number of milliseconds your transceiver needs to key up
  354.  
  355. MyCall=MY0CALL
  356.   Your Callsign (up to 8 characters)
  357.  
  358.  
  359. A.8. Section [LISTEN]
  360. ---------------------
  361.  
  362. CheapPactor=F
  363.   If you have a slow computer and it crashed when entering the listen mode
  364.   or "LOST INTS" is displayed, you may try to set this parameter to T
  365.  
  366.  
  367. A.9. Section [PACTOR_CALLS]
  368. ---------------------------
  369.  
  370. Call##=CA0LL
  371.   You may specify a list of the calls you use often. The calls entered here
  372.   appear in the Pactor Call menu, so you don't have to type them.
  373.   ## are consecutive numbers starting with 00.
  374.  
  375.  
  376. A.10. Section [AMTOR_CALLS]
  377. ---------------------------
  378.  
  379. Call##=CALL
  380.   You may specify a list of the amtor selcalls you use often.
  381.   The selcalls entered here appear in the Amtor Call menu,
  382.   so you don't have to type them.
  383.   ## are consecutive numbers starting with 00.
  384.  
  385.  
  386. A.11. Section [FILES]
  387. ---------------------
  388.  
  389. Desc##=Title
  390. Name##=Filename
  391.   This is a list of the text files you need often. These files appear in
  392.   the send file menu. ## are consecutive numbers starting with 00.
  393.  
  394. A.12. Section [CWID]
  395. --------------------
  396.  
  397. Speed=180
  398.   This is the speed (paris) of the CW id. Set it to a high number
  399.   (eg. 180 to 240) to keep the interruption of the data transfer
  400.   as short as possible.
  401.  
  402. Interval=600
  403.   This is the interval in seconds of the CW id during an ARQ QSO. Set it
  404.   to the highest value which is allowed (set it to 0 to disable CW ID-ing
  405.   during an ARQ QSO if you needn't do CW id-ing)
  406.  
  407. Call=MY0CALL
  408.   The text which should be sent as CW id. Omit it if you do not want any
  409.   CW id.
  410.  
  411.